使用put-bucket-encryption配置存储空间的加密规则

put-bucket-encryption用于配置存储空间（Bucket）的加密规则。

注意事项

阿里云账号默认拥有配置Bucket的加密规则的权限。如果您需要通过RAM用户或者STS的方式进行添加修改，您必须拥有oss:PutBucketEncryption权限。具体操作，请参见为RAM用户授权自定义的权限策略。

命令格式

ossutil api put-bucket-encryption --bucket value --server-side-encryption-rule value [flags]

参数	类型	说明
--bucket	string	Bucket的名称。
--server-side-encryption-rule	string	服务器端加密规则的容器。

说明

put-bucket-encryption命令对应API接口PutBucketEncryption。关于API中的具体参数含义，请参见PutBucketEncryption。

--server-side-encryption-rule

--server-side-encryption-rule配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

XML语法：

<ServerSideEncryptionRule>
  <ApplyServerSideEncryptionByDefault>
    <SSEAlgorithm>string</SSEAlgorithm>
    <KMSMasterKeyID>string</KMSMasterKeyID>
    <KMSDataEncryption>string</KMSDataEncryption>
  </ApplyServerSideEncryptionByDefault>
</ServerSideEncryptionRule>

JSON语法：

{
  "ApplyServerSideEncryptionByDefault": {
    "SSEAlgorithm": "string",
    "KMSMasterKeyID": "string",
    "KMSDataEncryption": "string"
  }
}

说明

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

以下示例展示了如何设置存储空间examplebucket服务端加密方式为AES256。

使用XML配置文件，server-side-encryption-rule.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<ServerSideEncryptionRule>
  <ApplyServerSideEncryptionByDefault>
    <SSEAlgorithm>AES256</SSEAlgorithm>
    <KMSMasterKeyID></KMSMasterKeyID>
  </ApplyServerSideEncryptionByDefault>
</ServerSideEncryptionRule>

命令示例如下：

ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.xml

使用JSON配置文件，server-side-encryption-rule.json内容如下：

{
  "ApplyServerSideEncryptionByDefault": {
    "SSEAlgorithm": "AES256"
  }
}

命令示例如下：

ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.json

使用JSON配置参数，命令示例如下：

ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule "{\"ApplyServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"AES256\"}}"